home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ARexxTools / DateCheck.lzh / DateCheck / DateCheck.Doc < prev    next >
Encoding:
Text File  |  1993-01-10  |  5.7 KB  |  132 lines
  1.                               DATECHECK
  2.                               ---------
  3.  
  4.                     Version 1.01  -  December 1992
  5.  
  6.                    Copyright © Michael Tanzer, 1992
  7.  
  8. +---------------------------------------------------------------------------+
  9. |                             N O T I C E                                   |
  10. |                                                                           |
  11. | Freely distributable.  Not to be used for commercial purposes without     |
  12. | written consent from the author.  Not to be distributed without this      |
  13. | notice and accompanying components intact.                                |
  14. |                                                                           |
  15. | This product is distributed on an 'as-is' basis, with no warranty of any  |
  16. | kind, either express or implied.  No responsibility whatsoever is assumed |
  17. | by the author for the use of this product, nor for any results of its     |
  18. | use.  No claim whatsoever is made as to this product's accuracy, useful-  |
  19. | ness, completeness, nor suitability to any purpose.                       |
  20. |                                                                           |
  21. | Components include the following files:                                   |
  22. |   DateCheck.Doc (this document)                                           |
  23. |   DateCheck                                                               |
  24. |                                                                           |
  25. +---------------------------------------------------------------------------+
  26.  
  27.  
  28. What is DateCheck?
  29. ------------------
  30.  
  31. DateCheck is a Rexx program that can be used to validate the system date
  32. whenever you boot your machine.
  33.  
  34.  
  35. Why use DateCheck?
  36. ------------------
  37.  
  38. If you use a battery backed-up clock, you probably know that it can be
  39. accidently set to an incorrect date.  If you don't use one, you may have
  40. entered the date incorrectly yourself.  In either case, if you run for a
  41. while with the wrong date, all sorts of odd things may happen.  If you use
  42. a program like Burf (which backs up modified files, using file dates to
  43. determine which files have been modified), your backups may be incomplete;
  44. if you use a program like Notify (which issues messages at certain times or
  45. on certain days), you get your messages at the wrong time or not at all.
  46.  
  47. DateCheck addresses this problem by storing the system date in a file
  48. (usually S:DateCheck.date).  Each time you run DateCheck, it compares the
  49. current system date with the stored date; if the system date is earlier
  50. or too much later, you are told about it.
  51.  
  52. Best of all, DateCheck is written in Rexx, so if you want to add or change
  53. a feature, you can do it easily.  And it's free.
  54.  
  55.  
  56. What you need in order to use DateCheck:
  57. ----------------------------------------
  58.  
  59. You must have the following libraries in your LIBS: directory:
  60.   rexxsyslib.library    (version 36.17 or later)
  61.   rexxsupport.library   (version 34.9 or later)
  62.   rexxarplib.library    (version 2.52 or later)
  63.   arp.library           (version 39.1 or later)
  64.   screenshare.library   (version 1.46 or later)
  65. These are available from a variety of sources and are not distributed with
  66. DateCheck.
  67.  
  68.  
  69. How to use DateCheck:
  70. ---------------------
  71.  
  72. Copy DateCheck into the directory to which rexx: has been assigned.  To run
  73. DateCheck whenever your machine is booted, place the line:
  74.   rx DateCheck
  75. in your User-Startup or Startup-Sequence.
  76.  
  77. Edit DateCheck and check the setting of the variables 'datefile' and
  78. 'maxdays'.  Set 'datefile' to indicate the file in which the system date
  79. will be stored.  Set 'maxdays' to indicate the maximum number of days that
  80. may pass between executions of DateCheck.  If you use your machine every
  81. day, you will want to set 'maxdays' to 1.
  82.  
  83. To run DateCheck for the first time, make sure the system date is correct,
  84. then enter:
  85.     RX DATECHECK RESET
  86. This will cause the the system date to be stored without being compared to
  87. a stored date.
  88.  
  89. Once a system date has been stored, each time DateCheck is run it will
  90. compare the current system date to the stored date:
  91.   If the system date is the same as the stored date, no further action is
  92.     taken.
  93.   If the system date is within the number of days specified as 'maxdays'
  94.     after the stored date, it will be stored for use with the next running
  95.     of DateCheck.
  96.   If the system date is earlier than the stored date or more than
  97.     'maxdays' after the stored date, a requester will appear telling you
  98.     what the system date is:
  99.       If the system date is correct, select the 'No Problem!' button and
  100.         the date will be stored.  (This will happen if 'maxdays' is set
  101.         to 1 but you haven't used your machine for two days or more.)
  102.       If the system date is incorrect, select the other button or close
  103.         the requester so the incorrect date will not be stored.  Then use
  104.         the DATE and/or SETCLOCK commands to set the system date correctly
  105.         and optionally enter 'RX DATECHECK RESET' to store it.
  106.  
  107.  
  108. Version log:
  109. ------------
  110.  
  111. 1.00  JUL 1992  Original release.
  112. 1.01  DEC 1992  Minor documentation changes.
  113.  
  114.  
  115. Other things you might like to know about DateCheck:
  116. ----------------------------------------------------
  117.  
  118. You are free use DateCheck for as long as you like and to modify it in any
  119. way that suits your needs, but please do not distribute a modified version.
  120. I do not ask for any remuneration, but if you would like to send me
  121. something (a holiday in Tahiti would be nice), I would be delighted to
  122. receive it.  I will make a sincere effort to answer any questions you may
  123. have about DateCheck.  My address is:
  124.  
  125.     Michael Tanzer
  126.     P.O. Box 289
  127.     Carlton North, VIC 3054
  128.     Australia
  129.  
  130.     Telephone:  +61 3 387 6589
  131.     Facsimile:  +61 3 388 1863
  132.